The program runs on compiled basic. It is published under the ShuBox Filing ¬ label.
Registration fee for users is $20.00
It is written for the Apple¿ Macintosh ¬ computers 512e or larger. This software was created using the ZBasic¬ Compiler. Portions of the code are ⌐ Copyrighted, 1985, 1986, and 1987 by Zedcor Inc.
This program has been tested and should operate as described below. However, the author/developer of MUSIC LIBRARIAN makes NO WARRANTY, EXPRESS or IMPLIED, as to the performance, merchantability, or fitness for any particular use; and neither does the author/developer assume any responsibility for any loss of information resulting from damage to program diskettes or program crashes. The author /developer may revise the program from time to time. The diskette comes with the program and two files along with this set of instructions. The program has not been run on an 128 K computer. It was developed on a MAC+¬ with a hard disk. An internal sorting routine in the program makes allowance for 5000 files. Each record is 400 bytes in length. You may not have disk room for 5000 files on your disk It depends on your storage medium. 5000 files on MUSIC LIBRARIAN take up 2,000,000 bytes of disk storage. If you elect to alphabetize the disk files (that is rearrange their order on the disk in order to save a little time when the program executes listing routines then the same 5000 files take up 4,000,000 by bytes of disk storage. The arrays and string set aside space set up by certain program steps take up approximately 70K of RAM.
MENUS
There are three menus as follows:
"MUSIC RECORDS","DEFINITIONS, and "DISK MGMNT"
FIRST THINGS YOU SHOULD DO TO ACQUAINT YOURSELF WITH MUSIC LIBRARIAN
1) Look over the instructions. If you don't set up your disk, and you try to use MUSIC LIBRARIAN, then the system may return errors because the program tries to access disk files which are not there.
2) Transfer MUSIC LIBRARIAN to your disk. Keep the data files in the same folder with the program. Data files have a slightly different Icon and the data files have the word "DATA" as part of the Icon, whereas MUSIC LIBRARIAN has "PROG" as part of its Icon.
3) Set up your disk, put in a few records , and just generally experiment around with the program.
MUSIC RECORDS
"OPEN NEW RECORD" is your selection for entering data on a particular piece of music. Textual entries are: Title(40*), Composer(35*), Arranger/Editor(35*), Remarks(40*), Publisher(20*), and name of Volume(30*) if applicable. The remaining entries are mouse selectable from choices presented to the user on the screen. When the options window is presented, you may not know or desire to make such an assignment at that time. You can change this under EDIT EXISTING RCRD below. If the piece of music has been put in the BAND/ORCH category, the program presents you with an inventory window for entering the number of copies available in your inventory by instrument as appropriate.
* number of characters per entry
"EDIT EXISTING RECORD" provides a means whereby the user may call up, by record number, a particular record for the editing of entries entered by the "OPEN NEW RCRD" selection. If you did not make any optional assignments for a piece of music when you created the record under OPEN NEW RCRD above you will notice that the edit box # OPTIONS in the edit window displays 0. If you, when editing, decide to make an optional assignment to that piece, you must type in a number between 1 and 28
(as long as it is > 0) into the # OPTIONS edit box. The program then will present you with an options window into which you type a 1 beside each of the options that you desire to assign to that piece. Under OPEN NEW RCRD above this option window is always presented, but for some reason or other you may not know or desire to make such an assignment at that time. Upon closing the edit window the program sums up all the entered 1's and stores that as the # OPTIONS for future program use in other places. WHEN
EDITING A RECORD in both the keyboard data (Title, Composer, etc) and the data selected by your mouse (Season, Category, etc) you should edit the the keyboard data after finishing the mouse selected data. MUSIC LIBRARIAN permits you to see the title of any file selected for editing before you call the file up for editing. If it isn't the title you want then you may select another file number, and on and on.
"SEARCH RECORDS" provides for thumbing through your entered records and selecting from among them those which meet your preselected criteria. You may select up to 11 different criteria*** plus up to 28 optionally selected criteria simultaneously. The 11 are in addition to the mandatory selection of Category. Searching by publisher is not provided. After the search you can list the results to screen or paper, with full record info or just title and record number info.
CATEGORY SEARCH CRITERIA
SACRED/SECULAR BAND/ORCHESTRA
TITLE*** TITLE***
COMPOSER*** COMPOSER***
ARR/ED*** ARR/ED***
REMARKS*** REMARKS***
MEDIUM MEDIUM
SEASON SEASON
VOICE RATING
THEME FORM
ACCOMPANIMENT ACCOMPANIMENT
STYLE STYLE
VOLUME*** VOLUME***
*** Uses a string searching technique for match ups.
NOTE ABOUT string searches: When conducting a search by a string of alphanumeric characters (A, a, B, b,..., Z, z, 1, 2,..., 0) it is only necessary to give the program a sufficient amount of the characters to exclusively identify the TITLE, ARR/ED, etc for which you wish to search. E.G.; you may decide to use the 40 bytes available in the remarks entries for more than one type of information such as last date of performance, your subjective opinion on the music, whether or not it is a good teaching tool, and whether or not it is popular with a certain group such as alumni. A remarks entry may look like this: 10/18/1985 NOT VERY EXCITING GOOD TEACH ALUMNI LIKE. If you were to do a search in which you are looking for pieces that may be popular at homecoming you may select REMARKS as one of your screening criteria and type in as a keyword ALUMN and the program would pick out all pieces that meet your other selected criteria, if any,(CATEGORY must always be selected) and which have ALUMN located
anywhere in the remarks entry. Another example would be if you decided to search for all pieces performed in the 1980's you could use the keyword 198 under the REMARKS criteria and the program would find all pieces that had 1980, 1981,..., 1989 anywhere in the remarks entry. If you wanted to be more specific then you could type in 1985 as your key word and the program would find only those pieces with 1985 in the remarks entry. In our example, the program would find our piece of music with either
198 or 1985 typed in as the keyword under REMARKS criteria for searching.
"LIST RECORDS" offers the user the choice between a sequential listing (the order in which you have entered the records) of records or an alphabetized listing. The user has no choice after a search (SEARCH RECORDS above) has been completed because the program alphabetizes the results before listing. Under the alphabetical selection in this menu MUSIC LIBRARIAN does not rearrange the disk records, but rather, does the alphabetizing in memory only and once the listing is completed, if this feature is selected again it must realphbetize before listing. Here again you can list either to the screen or to paper, either with full data or just titles and record number.
"DEFINE OPTIONAL CRITERIA" is the selection for labeling the optional criteria that you may want to help describe a record. You may have up to 28. This is the second item you should tend to after you have put in your DEFINITIONS under the DEFINITIONS menu below. Of course, if you do not intend to use this feature ignore it. A blank screen will be presented to you under OPEN NEW RCRD and EDIT EXISTING RECORD for each file. Just click OK and move past the window.
"DEFINE NAMES FOR SCORE INVENTORY" is the selection that allows the user to define up to 56 instrument or other score names (labels) that will appear on the inventory screen and other places for those records User designated as BAND/ORCHESTRA in the Category selection. Below are some examples, and the data file called "INSTRUMENT" included on the disk has the example names already entered. You can change them to your heart's desire or use them as is. If you decide to use them as is then transfer the INSTRuMENT file to your folder/diskette AFTER running the INITIAL DISK SETUP step below. The reason for this is that the Disk Setup sets up all blanks for the names of your scores. The same is true for the DEFINE data file below. IF YOU DECIDE TO START ALL OVER WITH YOUR OWN NAMES(LABELS) THEN YOU MUST MAKE THOSE ENTRIES BEFORE STARTING TO PUT IN YOUR RECORDS OR YOU WILL BE PRESENTED WITH BLANKS FOR YOUR CHOICES
"QUIT" sends you back to the desktop.
"DEFINITIONS"
There are 13 menu items under this menu. The first twelve allow for your entry of up to 30 definitions in the following categories:
SACRED SECULAR MEDIUM, BAND MEDIUM, SACRED SECULAR SEASON, BAND SEASON, SACRED SECULAR VOICE, BAND RATING, SACRED SECULAR THEME, BAND FORM, SACRED SECULAR ACCOMPANIMENT, BAND ACCOMPANIMENT, SACRED SECULAR STYLE, and BAND STYLE
Some typical but by no means exhaustive or exclusive examples are as follows:
RHYTHM & BLUES, ROCK, COUNTRY, FOLK, BROADWAY, POP, LATIN, MODERN, GOSPEL, CALYPSO, POLYNESIAN, EASTERN, JAZZ, HYMN, RAGTIME, AVANT GARDE, SPIRITUAL, BARBERSHOP, MARCH, CLASSICAL, RENAISSANCE, BAROQUE, ROMANTIC, IMPRESSIONISTIC, ART MUSIC, 20TH CENTURY
BAND STYLE
RHYTHM & BLUES, ROCK, COUNTRY, FOLK, BROADWAY, POP, LATIN, MODERN, GOSPEL, CALYPSO, POLYNESIAN, EASTERN, JAZZ, HYMN, RAGTIME, AVANT GARDE, SPIRITUAL, BARBERSHOP, MARCH, CLASSICAL, RENAISSANCE, BAROQUE, ROMANTIC, IMPRESSIONISTIC, ART MUSIC, 20TH CENTURY
SACRED SECULAR VOICE
S, A, T, B, SA, SAB, SATB, TTBB, SSAA, UNISON, SSA, SSAA, SSATBB, SSAATTBB, SAT, SSAB, TB, SSATB, SATBB, N/A
BAND RATING
1, 2, 3, 4, 5, 6, 7, 8, 9, 10
The disk comes with a data file called DEFINE, which as the above examples pre-entered. If you decide to use them "as is" then transfer this data file to your folder/diskette AFTER running the INITIAL DISK SETUP step below. The reason for this is that the Disk Setup routine places all blanks in for the names of your definitions. The same is true for the INSTRUMENT data file. IF YOU DECIDE TO START ALL OVER WITH YOUR OWN DEFINITIONS THEN YOU MUST MAKE THOSE ENTRIES BEFORE STARTING TO PUT IN YOUR RECORDS OR YOU WILL BE PRESENTED WITH BLANKS FOR YOUR CHOICES
"PRINT DEFINITIONS" lists your entries to paper for reference only.
DISK MGMNT
"INIT DISK SETUP" ** selection allows you to add dummy (blank) records to your disk storage device (floppy or hard disk) to the point that it is full. Remember that the program can only deal internally with a maximum of 5000 records. (If you would like me to allow for a larger number of files send me your disk and $5.00 for S&H and I will reconfigure your program for a larger number. However I suggest that you make a natural division of your music along some line and use separate drawers,
folders, or diskettes as appropriate, thus keeping your files down to a more manageable level. 5000 thousand records is a lot of data to manipulate on and off the disk if you, for example, are printing out a list of your music or alphabetizing) This selection in conjunction with "ADD DISK RECORDS" should allow tailoring of your files to the disk system that you use. One 400k disk with the program, operating system, finder, and printer driver will not have much space left for records. Each record is 400 bytes in length.
"ALPHABETIZE DISK RECORDS" Uses a disk based system of putting your files in alphabetical order. Whereas MUSIC LIBRARIAN alphabetizes your files each time you call upon it list your files under the ALPHABETICAL (as opposed to SEQ'NTL) choice (MUSIC RECORDS menu above w/LIST
RECORDS selection), This menu selection does it upon your choice only. After alphabetizing this routine restores the new alphabetized listing on disk; ie: your sequential listing has been rearranged on the disk to an alphabetical listing. As a sidelight-if you for some reason want to delete a record from your files, just edit that file and put in ZZZZ for the title. When alphabetizing your list the ZZZZ file(s) will be at the end of the list. The program will check for titles with ZZZZ anywhere in them and subtract 1 for each one found and set back your high record number file accordingly. e.g; if you put in ZZZZ for titles to three of your entries and you had a total of 356 entries on file, after alphabetizing the ZZZZ files would have been counted and the number of records reduced to 353.
"RESET #RCRDS" resets an internal file number that tracks the latest record you have entered under the "OPEN NEW RCRD" selection described below. For instance, you may have tailored your initial setup to accommodate 500 records, and you have entered 40 records thusfar. The number that "RESET #RCRDS" has in its internal file is 40. By resetting this number you can delete, as far as the program is concerned, a number of these records. In the example of 40, if you reset the #RCRDS to 35,
then the program would only deal with your 1st 35 records. You probably won't use this selection too frequently, if at all.
"ADD DISK RECORDS" permits you to add a selected number of blank records up to the point of filling your disk.
Note About Printouts
You can interrupt the printing of documents by holding down the command key and . simultaneously.
THE AUTHOR/DEVELOPER MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING THE ENCLOSED COMPUTER SOFTWARE PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES.
THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC LEGAL RIGHTS. THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE WHICH VARY FROM STATE TO STATE.
